MV_CC_DisplayOneFrame

MV_CC_DisplayOneFrame

Display one image frame.

API Definition

int MV_CC_DisplayOneFrame(
  void                     *handle,
  MV_DISPLAY_FRAME_INFO    *pDisplayInfo
);

Parameters

handle

[IN] Device handle, which is returned by MV_CC_CreateHandle or MV_CC_CreateHandleWithoutLog.

pDisplayInfo

[IN] Image information, see the structure MV_DISPLAY_FRAME_INFO for details.

Return Value

Return MV_OK(0) on success, and return Error Code on failure.

Remarks

  • This API is valid for USB3Vision camera and GIGE camera.

  • This API is not supported by CameraLink device.

The following sample code is for reference only.

#include "MvCameraControl.h"

void main()
{
    int nRet = -1;
    void* m_handle = NULL;

    //Enumerate all devices corresponding to specified transport protocol within subnet
     unsigned int nTLayerType = MV_GIGE_DEVICE | MV_USB_DEVICE;
    MV_CC_DEVICE_INFO_LIST m_stDevList = {0};
    int nRet = MV_CC_EnumDevices(nTLayerType, &m_stDevList);
    if (MV_OK != nRet)
    {
        printf("error: EnumDevices fail [%x]\n", nRet);
        return;
    }

    int i = 0;
    if (m_stDevList.nDeviceNum == 0)
    {
        printf("no camera found!\n");
        return;
    }

    //Select the first found online device and create device handle
    int nDeviceIndex = 0;

    MV_CC_DEVICE_INFO m_stDevInfo = {0};
    memcpy(&m_stDevInfo, m_stDevList.pDeviceInfo[nDeviceIndex], sizeof(MV_CC_DEVICE_INFO));

    nRet = MV_CC_CreateHandle(&m_handle, &m_stDevInfo);

    if (MV_OK != nRet)
    {
        printf("error: CreateHandle fail [%x]\n", nRet);
        return;
    }

    //Connect to device
     nRet = MV_CC_OpenDevice(m_handle, nAccessMode, nSwitchoverKey);
    if (MV_OK != nRet)
    {
        printf("error: OpenDevice fail [%x]\n", nRet);
        return;
    }
    //...other processing

     //Start acquiring image
     nRet = MV_CC_StartGrabbing(m_handle);
    if (MV_OK != nRet)
    {
        printf("error: StartGrabbing fail [%x]\n", nRet);
        return;
    }

    MV_FRAME_OUT stOutFrame;
    memset(&stOutFrame, 0, sizeof(MV_FRAME_OUT));
    MV_DISPLAY_FRAME_INFO stDisplayOneFrame;
    memset(&stDisplayOneFrame, 0, sizeof(MV_DISPLAY_FRAME_INFO));

    //The frequency of calling this API should be controlled by upper layer application according to frame rate
     //The codes are for reference only. In practical application, it is recommended to create a new thread for image acquisition and processing.
     while(1)
    {
        if (nTestFrameSize > 99) 
        {
            break;
        }
        nRet = MV_CC_GetImageBuffer(m_handle, &stOutFrame, 1000);
        if (MV_OK != nRet)
        {
            Sleep(10);
        }
        else
        {
            //...Process image data
            nTestFrameSize++;
        }

        stDisplayOneFrame.hWnd = hWnd;        stDisplayOneFrame.pData = stFrameOut.pData;        stDisplayOneFrame.nDataLen = stFrameOut.stFrameInfo.nFrameLen;        stDisplayOneFrame.nWidth = stFrameOut.stFrameInfo.nWidth;        stDisplayOneFrame.nHeight = stFrameOut.stFrameInfo.nHeight;        stDisplayOneFrame.enPixelType = stFrameOut.stFrameInfo.enPixelType;
         nRet = MV_CC_DisplayOneFrame(m_handle, &stDisplayOneFrame);
        if(nRet != MV_OK)        {            printf("Display one frame fail! nRet [0x%x]\n", nRet);
        }

        nRet = MV_CC_FreeImageBuffer(m_handle, &stOutFrame);
        if(nRet != MV_OK)        {            printf("Free Image Buffer fail! nRet [0x%x]\n", nRet);
        }
    }

    //...other processing

     //Stop acquiring image
     nRet = MV_CC_StopGrabbing(m_handle);
    if (MV_OK != nRet)
    {
        printf("error: StopGrabbing fail [%x]\n", nRet);
        return;
    }

    //Shut down device and release resource
     nRet = MV_CC_CloseDevice(m_handle);
    if (MV_OK != nRet)
    {
        printf("error: CloseDevice fail [%x]\n", nRet);
        return;
    }

    //Destroy handle and release resource
     nRet = MV_CC_DestroyHandle(m_handle);
    if (MV_OK != nRet)
    {
        printf("error: DestroyHandle fail [%x]\n", nRet);
        return;
    }    
}

MV_CC_DisplayOneFrame

Display one image frame.

API Definition

int MV_CC_DisplayOneFrame(
  void                     *handle,
  MV_DISPLAY_FRAME_INFO    *pDisplayInfo
);

Parameters

handle

[IN] Device handle, which is returned by MV_CC_CreateHandle or MV_CC_CreateHandleWithoutLog.

pDisplayInfo

[IN] Image information, see the structure MV_DISPLAY_FRAME_INFO for details.

Return Value

Return MV_OK(0) on success, and return Error Code on failure.

Remarks

  • This API is valid for USB3Vision camera and GIGE camera.

  • This API is not supported by CameraLink device.

The following sample code is for reference only.

#include "MvCameraControl.h"

void main()
{
    int nRet = -1;
    void* m_handle = NULL;

    //Enumerate all devices corresponding to specified transport protocol within subnet
     unsigned int nTLayerType = MV_GIGE_DEVICE | MV_USB_DEVICE;
    MV_CC_DEVICE_INFO_LIST m_stDevList = {0};
    int nRet = MV_CC_EnumDevices(nTLayerType, &m_stDevList);
    if (MV_OK != nRet)
    {
        printf("error: EnumDevices fail [%x]\n", nRet);
        return;
    }

    int i = 0;
    if (m_stDevList.nDeviceNum == 0)
    {
        printf("no camera found!\n");
        return;
    }

    //Select the first found online device and create device handle
    int nDeviceIndex = 0;

    MV_CC_DEVICE_INFO m_stDevInfo = {0};
    memcpy(&m_stDevInfo, m_stDevList.pDeviceInfo[nDeviceIndex], sizeof(MV_CC_DEVICE_INFO));

    nRet = MV_CC_CreateHandle(&m_handle, &m_stDevInfo);

    if (MV_OK != nRet)
    {
        printf("error: CreateHandle fail [%x]\n", nRet);
        return;
    }

    //Connect to device
     nRet = MV_CC_OpenDevice(m_handle, nAccessMode, nSwitchoverKey);
    if (MV_OK != nRet)
    {
        printf("error: OpenDevice fail [%x]\n", nRet);
        return;
    }
    //...other processing

     //Start acquiring image
     nRet = MV_CC_StartGrabbing(m_handle);
    if (MV_OK != nRet)
    {
        printf("error: StartGrabbing fail [%x]\n", nRet);
        return;
    }

    MV_FRAME_OUT stOutFrame;
    memset(&stOutFrame, 0, sizeof(MV_FRAME_OUT));
    MV_DISPLAY_FRAME_INFO stDisplayOneFrame;
    memset(&stDisplayOneFrame, 0, sizeof(MV_DISPLAY_FRAME_INFO));

    //The frequency of calling this API should be controlled by upper layer application according to frame rate
     //The codes are for reference only. In practical application, it is recommended to create a new thread for image acquisition and processing.
     while(1)
    {
        if (nTestFrameSize > 99) 
        {
            break;
        }
        nRet = MV_CC_GetImageBuffer(m_handle, &stOutFrame, 1000);
        if (MV_OK != nRet)
        {
            Sleep(10);
        }
        else
        {
            //...Process image data
            nTestFrameSize++;
        }

        stDisplayOneFrame.hWnd = hWnd;        stDisplayOneFrame.pData = stFrameOut.pData;        stDisplayOneFrame.nDataLen = stFrameOut.stFrameInfo.nFrameLen;        stDisplayOneFrame.nWidth = stFrameOut.stFrameInfo.nWidth;        stDisplayOneFrame.nHeight = stFrameOut.stFrameInfo.nHeight;        stDisplayOneFrame.enPixelType = stFrameOut.stFrameInfo.enPixelType;
         nRet = MV_CC_DisplayOneFrame(m_handle, &stDisplayOneFrame);
        if(nRet != MV_OK)        {            printf("Display one frame fail! nRet [0x%x]\n", nRet);
        }

        nRet = MV_CC_FreeImageBuffer(m_handle, &stOutFrame);
        if(nRet != MV_OK)        {            printf("Free Image Buffer fail! nRet [0x%x]\n", nRet);
        }
    }

    //...other processing

     //Stop acquiring image
     nRet = MV_CC_StopGrabbing(m_handle);
    if (MV_OK != nRet)
    {
        printf("error: StopGrabbing fail [%x]\n", nRet);
        return;
    }

    //Shut down device and release resource
     nRet = MV_CC_CloseDevice(m_handle);
    if (MV_OK != nRet)
    {
        printf("error: CloseDevice fail [%x]\n", nRet);
        return;
    }

    //Destroy handle and release resource
     nRet = MV_CC_DestroyHandle(m_handle);
    if (MV_OK != nRet)
    {
        printf("error: DestroyHandle fail [%x]\n", nRet);
        return;
    }    
}